/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / Python 1.3 / source code / Doc / libposix.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 70 6f 73 69 78 | 7d 7d 0d 5c 62 69 6d 6f |de{posix|}}.\bimo|
|00000030| 64 69 6e 64 65 78 7b 70 | 6f 73 69 78 7d 0d 0d 54 |dindex{p|osix}..T|
|00000040| 68 69 73 20 6d 6f 64 75 | 6c 65 20 70 72 6f 76 69 |his modu|le provi|
|00000050| 64 65 73 20 61 63 63 65 | 73 73 20 74 6f 20 6f 70 |des acce|ss to op|
|00000060| 65 72 61 74 69 6e 67 20 | 73 79 73 74 65 6d 20 66 |erating |system f|
|00000070| 75 6e 63 74 69 6f 6e 61 | 6c 69 74 79 20 74 68 61 |unctiona|lity tha|
|00000080| 74 20 69 73 0d 73 74 61 | 6e 64 61 72 64 69 7a 65 |t is.sta|ndardize|
|00000090| 64 20 62 79 20 74 68 65 | 20 43 20 53 74 61 6e 64 |d by the| C Stand|
|000000a0| 61 72 64 20 61 6e 64 20 | 74 68 65 20 50 4f 53 49 |ard and |the POSI|
|000000b0| 58 20 73 74 61 6e 64 61 | 72 64 20 28 61 20 74 68 |X standa|rd (a th|
|000000c0| 69 6e 6c 79 20 64 69 73 | 67 75 69 73 65 64 0d 5c |inly dis|guised.\|
|000000d0| 55 4e 49 58 7b 7d 20 69 | 6e 74 65 72 66 61 63 65 |UNIX{} i|nterface|
|000000e0| 29 2e 0d 0d 5c 73 74 72 | 6f 6e 67 7b 44 6f 20 6e |)...\str|ong{Do n|
|000000f0| 6f 74 20 69 6d 70 6f 72 | 74 20 74 68 69 73 20 6d |ot impor|t this m|
|00000100| 6f 64 75 6c 65 20 64 69 | 72 65 63 74 6c 79 2e 7d |odule di|rectly.}|
|00000110| 20 20 49 6e 73 74 65 61 | 64 2c 20 69 6d 70 6f 72 |  Instea|d, impor|
|00000120| 74 20 74 68 65 0d 6d 6f | 64 75 6c 65 20 5c 63 6f |t the.mo|dule \co|
|00000130| 64 65 7b 6f 73 7d 2c 20 | 77 68 69 63 68 20 70 72 |de{os}, |which pr|
|00000140| 6f 76 69 64 65 73 20 61 | 20 5c 65 6d 70 68 7b 70 |ovides a| \emph{p|
|00000150| 6f 72 74 61 62 6c 65 7d | 20 76 65 72 73 69 6f 6e |ortable}| version|
|00000160| 20 6f 66 20 74 68 69 73 | 0d 69 6e 74 65 72 66 61 | of this|.interfa|
|00000170| 63 65 2e 20 20 4f 6e 20 | 5c 55 4e 49 58 7b 7d 2c |ce.  On |\UNIX{},|
|00000180| 20 74 68 65 20 5c 63 6f | 64 65 7b 6f 73 7d 20 6d | the \co|de{os} m|
|00000190| 6f 64 75 6c 65 20 70 72 | 6f 76 69 64 65 73 20 61 |odule pr|ovides a|
|000001a0| 20 73 75 70 65 72 73 65 | 74 20 6f 66 0d 74 68 65 | superse|t of.the|
|000001b0| 20 5c 63 6f 64 65 7b 70 | 6f 73 69 78 7d 20 69 6e | \code{p|osix} in|
|000001c0| 74 65 72 66 61 63 65 2e | 20 20 4f 6e 20 6e 6f 6e |terface.|  On non|
|000001d0| 2d 5c 55 4e 49 58 7b 7d | 20 6f 70 65 72 61 74 69 |-\UNIX{}| operati|
|000001e0| 6e 67 20 73 79 73 74 65 | 6d 73 20 74 68 65 0d 5c |ng syste|ms the.\|
|000001f0| 63 6f 64 65 7b 70 6f 73 | 69 78 7d 20 6d 6f 64 75 |code{pos|ix} modu|
|00000200| 6c 65 20 69 73 20 6e 6f | 74 20 61 76 61 69 6c 61 |le is no|t availa|
|00000210| 62 6c 65 2c 20 62 75 74 | 20 61 20 73 75 62 73 65 |ble, but| a subse|
|00000220| 74 20 69 73 20 61 6c 77 | 61 79 73 20 61 76 61 69 |t is alw|ays avai|
|00000230| 6c 61 62 6c 65 0d 74 68 | 72 6f 75 67 68 20 74 68 |lable.th|rough th|
|00000240| 65 20 5c 63 6f 64 65 7b | 6f 73 7d 20 69 6e 74 65 |e \code{|os} inte|
|00000250| 72 66 61 63 65 2e 20 20 | 4f 6e 63 65 20 5c 63 6f |rface.  |Once \co|
|00000260| 64 65 7b 6f 73 7d 20 69 | 73 20 69 6d 70 6f 72 74 |de{os} i|s import|
|00000270| 65 64 2c 20 74 68 65 72 | 65 20 69 73 0d 5c 65 6d |ed, ther|e is.\em|
|00000280| 70 68 7b 6e 6f 7d 20 70 | 65 72 66 6f 72 6d 61 6e |ph{no} p|erforman|
|00000290| 63 65 20 70 65 6e 61 6c | 74 79 20 69 6e 20 75 73 |ce penal|ty in us|
|000002a0| 69 6e 67 20 69 74 20 69 | 6e 73 74 65 61 64 20 6f |ing it i|nstead o|
|000002b0| 66 0d 5c 63 6f 64 65 7b | 70 6f 73 69 78 7d 2e 0d |f.\code{|posix}..|
|000002c0| 5c 73 74 6d 6f 64 69 6e | 64 65 78 7b 6f 73 7d 0d |\stmodin|dex{os}.|
|000002d0| 0d 54 68 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |.The des|cription|
|000002e0| 73 20 62 65 6c 6f 77 20 | 61 72 65 20 76 65 72 79 |s below |are very|
|000002f0| 20 74 65 72 73 65 3b 20 | 72 65 66 65 72 20 74 6f | terse; |refer to|
|00000300| 20 74 68 65 0d 63 6f 72 | 72 65 73 70 6f 6e 64 69 | the.cor|respondi|
|00000310| 6e 67 20 5c 55 4e 49 58 | 7b 7d 20 6d 61 6e 75 61 |ng \UNIX|{} manua|
|00000320| 6c 20 65 6e 74 72 79 20 | 66 6f 72 20 6d 6f 72 65 |l entry |for more|
|00000330| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 20 20 41 | informa|tion.  A|
|00000340| 72 67 75 6d 65 6e 74 73 | 0d 63 61 6c 6c 65 64 20 |rguments|.called |
|00000350| 5c 76 61 72 7b 70 61 74 | 68 7d 20 72 65 66 65 72 |\var{pat|h} refer|
|00000360| 20 74 6f 20 61 20 70 61 | 74 68 6e 61 6d 65 20 67 | to a pa|thname g|
|00000370| 69 76 65 6e 20 61 73 20 | 61 20 73 74 72 69 6e 67 |iven as |a string|
|00000380| 2e 0d 0d 45 72 72 6f 72 | 73 20 61 72 65 20 72 65 |...Error|s are re|
|00000390| 70 6f 72 74 65 64 20 61 | 73 20 65 78 63 65 70 74 |ported a|s except|
|000003a0| 69 6f 6e 73 3b 20 74 68 | 65 20 75 73 75 61 6c 20 |ions; th|e usual |
|000003b0| 65 78 63 65 70 74 69 6f | 6e 73 20 61 72 65 20 67 |exceptio|ns are g|
|000003c0| 69 76 65 6e 0d 66 6f 72 | 20 74 79 70 65 20 65 72 |iven.for| type er|
|000003d0| 72 6f 72 73 2c 20 77 68 | 69 6c 65 20 65 72 72 6f |rors, wh|ile erro|
|000003e0| 72 73 20 72 65 70 6f 72 | 74 65 64 20 62 79 20 74 |rs repor|ted by t|
|000003f0| 68 65 20 73 79 73 74 65 | 6d 20 63 61 6c 6c 73 20 |he syste|m calls |
|00000400| 72 61 69 73 65 0d 5c 63 | 6f 64 65 7b 70 6f 73 69 |raise.\c|ode{posi|
|00000410| 78 2e 65 72 72 6f 72 7d | 2c 20 64 65 73 63 72 69 |x.error}|, descri|
|00000420| 62 65 64 20 62 65 6c 6f | 77 2e 0d 0d 4d 6f 64 75 |bed belo|w...Modu|
|00000430| 6c 65 20 5c 63 6f 64 65 | 7b 70 6f 73 69 78 7d 20 |le \code|{posix} |
|00000440| 64 65 66 69 6e 65 73 20 | 74 68 65 20 66 6f 6c 6c |defines |the foll|
|00000450| 6f 77 69 6e 67 20 64 61 | 74 61 20 69 74 65 6d 73 |owing da|ta items|
|00000460| 3a 0d 0d 5c 72 65 6e 65 | 77 63 6f 6d 6d 61 6e 64 |:..\rene|wcommand|
|00000470| 7b 5c 69 6e 64 65 78 73 | 75 62 69 74 65 6d 7d 7b |{\indexs|ubitem}{|
|00000480| 28 64 61 74 61 20 69 6e | 20 6d 6f 64 75 6c 65 20 |(data in| module |
|00000490| 70 6f 73 69 78 29 7d 0d | 5c 62 65 67 69 6e 7b 64 |posix)}.|\begin{d|
|000004a0| 61 74 61 64 65 73 63 7d | 7b 65 6e 76 69 72 6f 6e |atadesc}|{environ|
|000004b0| 7d 0d 41 20 64 69 63 74 | 69 6f 6e 61 72 79 20 72 |}.A dict|ionary r|
|000004c0| 65 70 72 65 73 65 6e 74 | 69 6e 67 20 74 68 65 20 |epresent|ing the |
|000004d0| 73 74 72 69 6e 67 20 65 | 6e 76 69 72 6f 6e 6d 65 |string e|nvironme|
|000004e0| 6e 74 20 61 74 20 74 68 | 65 20 74 69 6d 65 0d 74 |nt at th|e time.t|
|000004f0| 68 65 20 69 6e 74 65 72 | 70 72 65 74 65 72 20 77 |he inter|preter w|
|00000500| 61 73 20 73 74 61 72 74 | 65 64 2e 0d 46 6f 72 20 |as start|ed..For |
|00000510| 65 78 61 6d 70 6c 65 2c | 0d 5c 63 6f 64 65 7b 70 |example,|.\code{p|
|00000520| 6f 73 69 78 2e 65 6e 76 | 69 72 6f 6e 5b 27 48 4f |osix.env|iron['HO|
|00000530| 4d 45 27 5d 7d 0d 69 73 | 20 74 68 65 20 70 61 74 |ME']}.is| the pat|
|00000540| 68 6e 61 6d 65 20 6f 66 | 20 79 6f 75 72 20 68 6f |hname of| your ho|
|00000550| 6d 65 20 64 69 72 65 63 | 74 6f 72 79 2c 20 65 71 |me direc|tory, eq|
|00000560| 75 69 76 61 6c 65 6e 74 | 20 74 6f 0d 5c 63 6f 64 |uivalent| to.\cod|
|00000570| 65 7b 67 65 74 65 6e 76 | 28 22 48 4f 4d 45 22 29 |e{getenv|("HOME")|
|00000580| 7d 0d 69 6e 20 43 2e 0d | 4d 6f 64 69 66 79 69 6e |}.in C..|Modifyin|
|00000590| 67 20 74 68 69 73 20 64 | 69 63 74 69 6f 6e 61 72 |g this d|ictionar|
|000005a0| 79 20 64 6f 65 73 20 6e | 6f 74 20 61 66 66 65 63 |y does n|ot affec|
|000005b0| 74 20 74 68 65 20 73 74 | 72 69 6e 67 20 65 6e 76 |t the st|ring env|
|000005c0| 69 72 6f 6e 6d 65 6e 74 | 0d 70 61 73 73 65 64 20 |ironment|.passed |
|000005d0| 6f 6e 20 62 79 20 5c 63 | 6f 64 65 7b 65 78 65 63 |on by \c|ode{exec|
|000005e0| 76 28 29 7d 2c 20 5c 63 | 6f 64 65 7b 70 6f 70 65 |v()}, \c|ode{pope|
|000005f0| 6e 28 29 7d 20 6f 72 20 | 5c 63 6f 64 65 7b 73 79 |n()} or |\code{sy|
|00000600| 73 74 65 6d 28 29 7d 3b | 20 69 66 20 79 6f 75 0d |stem()};| if you.|
|00000610| 6e 65 65 64 20 74 6f 20 | 63 68 61 6e 67 65 20 74 |need to |change t|
|00000620| 68 65 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 2c 20 |he envir|onment, |
|00000630| 70 61 73 73 20 5c 63 6f | 64 65 7b 65 6e 76 69 72 |pass \co|de{envir|
|00000640| 6f 6e 7d 20 74 6f 20 5c | 63 6f 64 65 7b 65 78 65 |on} to \|code{exe|
|00000650| 63 76 65 28 29 7d 0d 6f | 72 20 61 64 64 20 76 61 |cve()}.o|r add va|
|00000660| 72 69 61 62 6c 65 20 61 | 73 73 69 67 6e 6d 65 6e |riable a|ssignmen|
|00000670| 74 73 20 61 6e 64 20 65 | 78 70 6f 72 74 20 73 74 |ts and e|xport st|
|00000680| 61 74 65 6d 65 6e 74 73 | 20 74 6f 20 74 68 65 20 |atements| to the |
|00000690| 63 6f 6d 6d 61 6e 64 0d | 73 74 72 69 6e 67 20 66 |command.|string f|
|000006a0| 6f 72 20 5c 63 6f 64 65 | 7b 73 79 73 74 65 6d 28 |or \code|{system(|
|000006b0| 29 7d 20 6f 72 20 5c 63 | 6f 64 65 7b 70 6f 70 65 |)} or \c|ode{pope|
|000006c0| 6e 28 29 7d 2e 25 0d 5c | 66 6f 6f 74 6e 6f 74 65 |n()}.%.\|footnote|
|000006d0| 7b 54 68 65 20 70 72 6f | 62 6c 65 6d 20 77 69 74 |{The pro|blem wit|
|000006e0| 68 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 20 |h automa|tically |
|000006f0| 70 61 73 73 69 6e 67 20 | 6f 6e 20 5c 63 6f 64 65 |passing |on \code|
|00000700| 7b 65 6e 76 69 72 6f 6e | 7d 20 69 73 0d 74 68 61 |{environ|} is.tha|
|00000710| 74 20 74 68 65 72 65 20 | 69 73 20 6e 6f 20 70 6f |t there |is no po|
|00000720| 72 74 61 62 6c 65 20 77 | 61 79 20 6f 66 20 63 68 |rtable w|ay of ch|
|00000730| 61 6e 67 69 6e 67 20 74 | 68 65 20 65 6e 76 69 72 |anging t|he envir|
|00000740| 6f 6e 6d 65 6e 74 2e 7d | 0d 5c 65 6e 64 7b 64 61 |onment.}|.\end{da|
|00000750| 74 61 64 65 73 63 7d 0d | 0d 5c 72 65 6e 65 77 63 |tadesc}.|.\renewc|
|00000760| 6f 6d 6d 61 6e 64 7b 5c | 69 6e 64 65 78 73 75 62 |ommand{\|indexsub|
|00000770| 69 74 65 6d 7d 7b 28 65 | 78 63 65 70 74 69 6f 6e |item}{(e|xception|
|00000780| 20 69 6e 20 6d 6f 64 75 | 6c 65 20 70 6f 73 69 78 | in modu|le posix|
|00000790| 29 7d 0d 5c 62 65 67 69 | 6e 7b 65 78 63 64 65 73 |)}.\begi|n{excdes|
|000007a0| 63 7d 7b 65 72 72 6f 72 | 7d 0d 54 68 69 73 20 65 |c}{error|}.This e|
|000007b0| 78 63 65 70 74 69 6f 6e | 20 69 73 20 72 61 69 73 |xception| is rais|
|000007c0| 65 64 20 77 68 65 6e 20 | 61 20 50 4f 53 49 58 20 |ed when |a POSIX |
|000007d0| 66 75 6e 63 74 69 6f 6e | 20 72 65 74 75 72 6e 73 |function| returns|
|000007e0| 20 61 0d 50 4f 53 49 58 | 2d 72 65 6c 61 74 65 64 | a.POSIX|-related|
|000007f0| 20 65 72 72 6f 72 20 28 | 65 2e 67 2e 2c 20 6e 6f | error (|e.g., no|
|00000800| 74 20 66 6f 72 20 69 6c | 6c 65 67 61 6c 20 61 72 |t for il|legal ar|
|00000810| 67 75 6d 65 6e 74 20 74 | 79 70 65 73 29 2e 20 20 |gument t|ypes).  |
|00000820| 49 74 73 0d 73 74 72 69 | 6e 67 20 76 61 6c 75 65 |Its.stri|ng value|
|00000830| 20 69 73 20 5c 63 6f 64 | 65 7b 27 70 6f 73 69 78 | is \cod|e{'posix|
|00000840| 2e 65 72 72 6f 72 27 7d | 2e 20 20 54 68 65 20 61 |.error'}|.  The a|
|00000850| 63 63 6f 6d 70 61 6e 79 | 69 6e 67 20 76 61 6c 75 |ccompany|ing valu|
|00000860| 65 20 69 73 20 61 0d 70 | 61 69 72 20 63 6f 6e 74 |e is a.p|air cont|
|00000870| 61 69 6e 69 6e 67 20 74 | 68 65 20 6e 75 6d 65 72 |aining t|he numer|
|00000880| 69 63 20 65 72 72 6f 72 | 20 63 6f 64 65 20 66 72 |ic error| code fr|
|00000890| 6f 6d 20 5c 63 6f 64 65 | 7b 65 72 72 6e 6f 7d 20 |om \code|{errno} |
|000008a0| 61 6e 64 20 74 68 65 0d | 63 6f 72 72 65 73 70 6f |and the.|correspo|
|000008b0| 6e 64 69 6e 67 20 73 74 | 72 69 6e 67 2c 20 61 73 |nding st|ring, as|
|000008c0| 20 77 6f 75 6c 64 20 62 | 65 20 70 72 69 6e 74 65 | would b|e printe|
|000008d0| 64 20 62 79 20 74 68 65 | 20 43 20 66 75 6e 63 74 |d by the| C funct|
|000008e0| 69 6f 6e 0d 5c 63 6f 64 | 65 7b 70 65 72 72 6f 72 |ion.\cod|e{perror|
|000008f0| 28 29 7d 2e 0d 5c 65 6e | 64 7b 65 78 63 64 65 73 |()}..\en|d{excdes|
|00000900| 63 7d 0d 0d 49 74 20 64 | 65 66 69 6e 65 73 20 74 |c}..It d|efines t|
|00000910| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 66 75 6e |he follo|wing fun|
|00000920| 63 74 69 6f 6e 73 20 61 | 6e 64 20 63 6f 6e 73 74 |ctions a|nd const|
|00000930| 61 6e 74 73 3a 0d 0d 5c | 72 65 6e 65 77 63 6f 6d |ants:..\|renewcom|
|00000940| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000950| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 70 |em}{(in |module p|
|00000960| 6f 73 69 78 29 7d 0d 5c | 62 65 67 69 6e 7b 66 75 |osix)}.\|begin{fu|
|00000970| 6e 63 64 65 73 63 7d 7b | 63 68 64 69 72 7d 7b 70 |ncdesc}{|chdir}{p|
|00000980| 61 74 68 7d 0d 43 68 61 | 6e 67 65 20 74 68 65 20 |ath}.Cha|nge the |
|00000990| 63 75 72 72 65 6e 74 20 | 77 6f 72 6b 69 6e 67 20 |current |working |
|000009a0| 64 69 72 65 63 74 6f 72 | 79 20 74 6f 20 5c 76 61 |director|y to \va|
|000009b0| 72 7b 70 61 74 68 7d 2e | 0d 5c 65 6e 64 7b 66 75 |r{path}.|.\end{fu|
|000009c0| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000009d0| 66 75 6e 63 64 65 73 63 | 7d 7b 63 68 6d 6f 64 7d |funcdesc|}{chmod}|
|000009e0| 7b 70 61 74 68 5c 2c 20 | 6d 6f 64 65 7d 0d 43 68 |{path\, |mode}.Ch|
|000009f0| 61 6e 67 65 20 74 68 65 | 20 6d 6f 64 65 20 6f 66 |ange the| mode of|
|00000a00| 20 5c 76 61 72 7b 70 61 | 74 68 7d 20 74 6f 20 74 | \var{pa|th} to t|
|00000a10| 68 65 20 6e 75 6d 65 72 | 69 63 20 5c 76 61 72 7b |he numer|ic \var{|
|00000a20| 6d 6f 64 65 7d 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |mode}..\|end{func|
|00000a30| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000a40| 6e 63 64 65 73 63 7d 7b | 63 68 6f 77 6e 7d 7b 70 |ncdesc}{|chown}{p|
|00000a50| 61 74 68 5c 2c 20 75 69 | 64 2c 20 67 69 64 7d 0d |ath\, ui|d, gid}.|
|00000a60| 43 68 61 6e 67 65 20 74 | 68 65 20 6f 77 6e 65 72 |Change t|he owner|
|00000a70| 20 61 6e 64 20 67 72 6f | 75 70 20 69 64 20 6f 66 | and gro|up id of|
|00000a80| 20 5c 76 61 72 7b 70 61 | 74 68 7d 20 74 6f 20 74 | \var{pa|th} to t|
|00000a90| 68 65 20 6e 75 6d 65 72 | 69 63 20 5c 76 61 72 7b |he numer|ic \var{|
|00000aa0| 75 69 64 7d 0d 61 6e 64 | 20 5c 76 61 72 7b 67 69 |uid}.and| \var{gi|
|00000ab0| 64 7d 2e 0d 28 4e 6f 74 | 20 6f 6e 20 4d 53 2d 44 |d}..(Not| on MS-D|
|00000ac0| 4f 53 2e 29 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |OS.).\en|d{funcde|
|00000ad0| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000ae0| 64 65 73 63 7d 7b 63 6c | 6f 73 65 7d 7b 66 64 7d |desc}{cl|ose}{fd}|
|00000af0| 0d 43 6c 6f 73 65 20 66 | 69 6c 65 20 64 65 73 63 |.Close f|ile desc|
|00000b00| 72 69 70 74 6f 72 20 5c | 76 61 72 7b 66 64 7d 2e |riptor \|var{fd}.|
|00000b10| 0d 0d 4e 6f 74 65 3a 20 | 74 68 69 73 20 66 75 6e |..Note: |this fun|
|00000b20| 63 74 69 6f 6e 20 69 73 | 20 69 6e 74 65 6e 64 65 |ction is| intende|
|00000b30| 64 20 66 6f 72 20 6c 6f | 77 2d 6c 65 76 65 6c 20 |d for lo|w-level |
|00000b40| 49 2f 4f 20 61 6e 64 20 | 6d 75 73 74 20 62 65 20 |I/O and |must be |
|00000b50| 61 70 70 6c 69 65 64 0d | 74 6f 20 61 20 66 69 6c |applied.|to a fil|
|00000b60| 65 20 64 65 73 63 72 69 | 70 74 6f 72 20 61 73 20 |e descri|ptor as |
|00000b70| 72 65 74 75 72 6e 65 64 | 20 62 79 20 5c 63 6f 64 |returned| by \cod|
|00000b80| 65 7b 70 6f 73 69 78 2e | 6f 70 65 6e 28 29 7d 20 |e{posix.|open()} |
|00000b90| 6f 72 0d 5c 63 6f 64 65 | 7b 70 6f 73 69 78 2e 70 |or.\code|{posix.p|
|00000ba0| 69 70 65 28 29 7d 2e 20 | 20 54 6f 20 63 6c 6f 73 |ipe()}. | To clos|
|00000bb0| 65 20 61 20 60 60 66 69 | 6c 65 20 6f 62 6a 65 63 |e a ``fi|le objec|
|00000bc0| 74 27 27 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |t'' retu|rned by |
|00000bd0| 74 68 65 0d 62 75 69 6c | 74 2d 69 6e 20 66 75 6e |the.buil|t-in fun|
|00000be0| 63 74 69 6f 6e 20 5c 63 | 6f 64 65 7b 6f 70 65 6e |ction \c|ode{open|
|00000bf0| 7d 20 6f 72 20 62 79 20 | 5c 63 6f 64 65 7b 70 6f |} or by |\code{po|
|00000c00| 73 69 78 2e 70 6f 70 65 | 6e 7d 20 6f 72 0d 5c 63 |six.pope|n} or.\c|
|00000c10| 6f 64 65 7b 70 6f 73 69 | 78 2e 66 64 6f 70 65 6e |ode{posi|x.fdopen|
|00000c20| 7d 2c 20 75 73 65 20 69 | 74 73 20 5c 63 6f 64 65 |}, use i|ts \code|
|00000c30| 7b 63 6c 6f 73 65 28 29 | 7d 20 6d 65 74 68 6f 64 |{close()|} method|
|00000c40| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000c50| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000c60| 63 7d 7b 64 75 70 7d 7b | 66 64 7d 0d 52 65 74 75 |c}{dup}{|fd}.Retu|
|00000c70| 72 6e 20 61 20 64 75 70 | 6c 69 63 61 74 65 20 6f |rn a dup|licate o|
|00000c80| 66 20 66 69 6c 65 20 64 | 65 73 63 72 69 70 74 6f |f file d|escripto|
|00000c90| 72 20 5c 76 61 72 7b 66 | 64 7d 2e 0d 5c 65 6e 64 |r \var{f|d}..\end|
|00000ca0| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 5c 62 65 67 |{funcdes|c}..\beg|
|00000cb0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 64 75 70 |in{funcd|esc}{dup|
|00000cc0| 32 7d 7b 66 64 5c 2c 20 | 66 64 32 7d 0d 44 75 70 |2}{fd\, |fd2}.Dup|
|00000cd0| 6c 69 63 61 74 65 20 66 | 69 6c 65 20 64 65 73 63 |licate f|ile desc|
|00000ce0| 72 69 70 74 6f 72 20 5c | 76 61 72 7b 66 64 7d 20 |riptor \|var{fd} |
|00000cf0| 74 6f 20 5c 76 61 72 7b | 66 64 32 7d 2c 20 63 6c |to \var{|fd2}, cl|
|00000d00| 6f 73 69 6e 67 20 74 68 | 65 20 6c 61 74 74 65 72 |osing th|e latter|
|00000d10| 0d 66 69 72 73 74 20 69 | 66 20 6e 65 63 65 73 73 |.first i|f necess|
|00000d20| 61 72 79 2e 20 20 52 65 | 74 75 72 6e 20 5c 63 6f |ary.  Re|turn \co|
|00000d30| 64 65 7b 4e 6f 6e 65 7d | 2e 0d 5c 65 6e 64 7b 66 |de{None}|..\end{f|
|00000d40| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000d50| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 65 78 65 63 76 |{funcdes|c}{execv|
|00000d60| 7d 7b 70 61 74 68 5c 2c | 20 61 72 67 73 7d 0d 45 |}{path\,| args}.E|
|00000d70| 78 65 63 75 74 65 20 74 | 68 65 20 65 78 65 63 75 |xecute t|he execu|
|00000d80| 74 61 62 6c 65 20 5c 76 | 61 72 7b 70 61 74 68 7d |table \v|ar{path}|
|00000d90| 20 77 69 74 68 20 61 72 | 67 75 6d 65 6e 74 20 6c | with ar|gument l|
|00000da0| 69 73 74 20 5c 76 61 72 | 7b 61 72 67 73 7d 2c 0d |ist \var|{args},.|
|00000db0| 72 65 70 6c 61 63 69 6e | 67 20 74 68 65 20 63 75 |replacin|g the cu|
|00000dc0| 72 72 65 6e 74 20 70 72 | 6f 63 65 73 73 20 28 69 |rrent pr|ocess (i|
|00000dd0| 2e 65 2e 2c 20 74 68 65 | 20 50 79 74 68 6f 6e 20 |.e., the| Python |
|00000de0| 69 6e 74 65 72 70 72 65 | 74 65 72 29 2e 0d 54 68 |interpre|ter)..Th|
|00000df0| 65 20 61 72 67 75 6d 65 | 6e 74 20 6c 69 73 74 20 |e argume|nt list |
|00000e00| 6d 61 79 20 62 65 20 61 | 20 74 75 70 6c 65 20 6f |may be a| tuple o|
|00000e10| 72 20 6c 69 73 74 20 6f | 66 20 73 74 72 69 6e 67 |r list o|f string|
|00000e20| 73 2e 0d 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |s..(Not |on MS-DO|
|00000e30| 53 2e 29 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |S.).\end|{funcdes|
|00000e40| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000e50| 65 73 63 7d 7b 65 78 65 | 63 76 65 7d 7b 70 61 74 |esc}{exe|cve}{pat|
|00000e60| 68 5c 2c 20 61 72 67 73 | 5c 2c 20 65 6e 76 7d 0d |h\, args|\, env}.|
|00000e70| 45 78 65 63 75 74 65 20 | 74 68 65 20 65 78 65 63 |Execute |the exec|
|00000e80| 75 74 61 62 6c 65 20 5c | 76 61 72 7b 70 61 74 68 |utable \|var{path|
|00000e90| 7d 20 77 69 74 68 20 61 | 72 67 75 6d 65 6e 74 20 |} with a|rgument |
|00000ea0| 6c 69 73 74 20 5c 76 61 | 72 7b 61 72 67 73 7d 2c |list \va|r{args},|
|00000eb0| 0d 61 6e 64 20 65 6e 76 | 69 72 6f 6e 6d 65 6e 74 |.and env|ironment|
|00000ec0| 20 5c 76 61 72 7b 65 6e | 76 7d 2c 0d 72 65 70 6c | \var{en|v},.repl|
|00000ed0| 61 63 69 6e 67 20 74 68 | 65 20 63 75 72 72 65 6e |acing th|e curren|
|00000ee0| 74 20 70 72 6f 63 65 73 | 73 20 28 69 2e 65 2e 2c |t proces|s (i.e.,|
|00000ef0| 20 74 68 65 20 50 79 74 | 68 6f 6e 20 69 6e 74 65 | the Pyt|hon inte|
|00000f00| 72 70 72 65 74 65 72 29 | 2e 0d 54 68 65 20 61 72 |rpreter)|..The ar|
|00000f10| 67 75 6d 65 6e 74 20 6c | 69 73 74 20 6d 61 79 20 |gument l|ist may |
|00000f20| 62 65 20 61 20 74 75 70 | 6c 65 20 6f 72 20 6c 69 |be a tup|le or li|
|00000f30| 73 74 20 6f 66 20 73 74 | 72 69 6e 67 73 2e 0d 54 |st of st|rings..T|
|00000f40| 68 65 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 20 6d |he envir|onment m|
|00000f50| 75 73 74 20 62 65 20 61 | 20 64 69 63 74 69 6f 6e |ust be a| diction|
|00000f60| 61 72 79 20 6d 61 70 70 | 69 6e 67 20 73 74 72 69 |ary mapp|ing stri|
|00000f70| 6e 67 73 20 74 6f 20 73 | 74 72 69 6e 67 73 2e 0d |ngs to s|trings..|
|00000f80| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00000f90| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00000fa0| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000fb0| 7d 7b 5f 65 78 69 74 7d | 7b 6e 7d 0d 45 78 69 74 |}{_exit}|{n}.Exit|
|00000fc0| 20 74 6f 20 74 68 65 20 | 73 79 73 74 65 6d 20 77 | to the |system w|
|00000fd0| 69 74 68 20 73 74 61 74 | 75 73 20 5c 76 61 72 7b |ith stat|us \var{|
|00000fe0| 6e 7d 2c 20 77 69 74 68 | 6f 75 74 20 63 61 6c 6c |n}, with|out call|
|00000ff0| 69 6e 67 20 63 6c 65 61 | 6e 75 70 0d 68 61 6e 64 |ing clea|nup.hand|
|00001000| 6c 65 72 73 2c 20 66 6c | 75 73 68 69 6e 67 20 73 |lers, fl|ushing s|
|00001010| 74 64 69 6f 20 62 75 66 | 66 65 72 73 2c 20 65 74 |tdio buf|fers, et|
|00001020| 63 2e 0d 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |c..(Not |on MS-DO|
|00001030| 53 2e 29 0d 0d 4e 6f 74 | 65 3a 20 74 68 65 20 73 |S.)..Not|e: the s|
|00001040| 74 61 6e 64 61 72 64 20 | 77 61 79 20 74 6f 20 65 |tandard |way to e|
|00001050| 78 69 74 20 69 73 20 5c | 63 6f 64 65 7b 73 79 73 |xit is \|code{sys|
|00001060| 2e 65 78 69 74 28 5c 76 | 61 72 7b 6e 7d 29 7d 2e |.exit(\v|ar{n})}.|
|00001070| 0d 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 5f 65 78 |.\code{p|osix._ex|
|00001080| 69 74 28 29 7d 20 73 68 | 6f 75 6c 64 20 6e 6f 72 |it()} sh|ould nor|
|00001090| 6d 61 6c 6c 79 20 6f 6e | 6c 79 20 62 65 20 75 73 |mally on|ly be us|
|000010a0| 65 64 20 69 6e 20 74 68 | 65 20 63 68 69 6c 64 20 |ed in th|e child |
|000010b0| 70 72 6f 63 65 73 73 0d | 61 66 74 65 72 20 61 20 |process.|after a |
|000010c0| 5c 63 6f 64 65 7b 66 6f | 72 6b 28 29 7d 2e 0d 5c |\code{fo|rk()}..\|
|000010d0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|000010e0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000010f0| 66 64 6f 70 65 6e 7d 7b | 66 64 5c 6f 70 74 69 6f |fdopen}{|fd\optio|
|00001100| 6e 61 6c 7b 5c 2c 20 6d | 6f 64 65 5c 6f 70 74 69 |nal{\, m|ode\opti|
|00001110| 6f 6e 61 6c 7b 5c 2c 20 | 62 75 66 73 69 7a 65 7d |onal{\, |bufsize}|
|00001120| 7d 7d 0d 52 65 74 75 72 | 6e 20 61 6e 20 6f 70 65 |}}.Retur|n an ope|
|00001130| 6e 20 66 69 6c 65 20 6f | 62 6a 65 63 74 20 63 6f |n file o|bject co|
|00001140| 6e 6e 65 63 74 65 64 20 | 74 6f 20 74 68 65 20 66 |nnected |to the f|
|00001150| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 5c |ile desc|riptor \|
|00001160| 76 61 72 7b 66 64 7d 2e | 0d 54 68 65 20 5c 76 61 |var{fd}.|.The \va|
|00001170| 72 7b 6d 6f 64 65 7d 20 | 61 6e 64 20 5c 76 61 72 |r{mode} |and \var|
|00001180| 7b 62 75 66 73 69 7a 65 | 7d 20 61 72 67 75 6d 65 |{bufsize|} argume|
|00001190| 6e 74 73 20 68 61 76 65 | 20 74 68 65 20 73 61 6d |nts have| the sam|
|000011a0| 65 20 6d 65 61 6e 69 6e | 67 20 61 73 0d 74 68 65 |e meanin|g as.the|
|000011b0| 20 63 6f 72 72 65 73 70 | 6f 6e 64 69 6e 67 20 61 | corresp|onding a|
|000011c0| 72 67 75 6d 65 6e 74 73 | 20 74 6f 20 74 68 65 20 |rguments| to the |
|000011d0| 62 75 69 6c 74 2d 69 6e | 20 5c 63 6f 64 65 7b 6f |built-in| \code{o|
|000011e0| 70 65 6e 28 29 7d 20 66 | 75 6e 63 74 69 6f 6e 2e |pen()} f|unction.|
|000011f0| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00001200| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001210| 7d 7b 66 6f 72 6b 7d 7b | 7d 0d 46 6f 72 6b 20 61 |}{fork}{|}.Fork a|
|00001220| 20 63 68 69 6c 64 20 70 | 72 6f 63 65 73 73 2e 20 | child p|rocess. |
|00001230| 20 52 65 74 75 72 6e 20 | 30 20 69 6e 20 74 68 65 | Return |0 in the|
|00001240| 20 63 68 69 6c 64 2c 20 | 74 68 65 20 63 68 69 6c | child, |the chil|
|00001250| 64 27 73 20 70 72 6f 63 | 65 73 73 20 69 64 0d 69 |d's proc|ess id.i|
|00001260| 6e 20 74 68 65 20 70 61 | 72 65 6e 74 2e 0d 28 4e |n the pa|rent..(N|
|00001270| 6f 74 20 6f 6e 20 4d 53 | 2d 44 4f 53 2e 29 0d 5c |ot on MS|-DOS.).\|
|00001280| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00001290| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000012a0| 66 73 74 61 74 7d 7b 66 | 64 7d 0d 52 65 74 75 72 |fstat}{f|d}.Retur|
|000012b0| 6e 20 73 74 61 74 75 73 | 20 66 6f 72 20 66 69 6c |n status| for fil|
|000012c0| 65 20 64 65 73 63 72 69 | 70 74 6f 72 20 5c 76 61 |e descri|ptor \va|
|000012d0| 72 7b 66 64 7d 2c 20 6c | 69 6b 65 20 5c 63 6f 64 |r{fd}, l|ike \cod|
|000012e0| 65 7b 73 74 61 74 28 29 | 7d 2e 0d 5c 65 6e 64 7b |e{stat()|}..\end{|
|000012f0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00001300| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 67 65 74 63 |n{funcde|sc}{getc|
|00001310| 77 64 7d 7b 7d 0d 52 65 | 74 75 72 6e 20 61 20 73 |wd}{}.Re|turn a s|
|00001320| 74 72 69 6e 67 20 72 65 | 70 72 65 73 65 6e 74 69 |tring re|presenti|
|00001330| 6e 67 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 77 |ng the c|urrent w|
|00001340| 6f 72 6b 69 6e 67 20 64 | 69 72 65 63 74 6f 72 79 |orking d|irectory|
|00001350| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001360| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001370| 63 7d 7b 67 65 74 65 67 | 69 64 7d 7b 7d 0d 52 65 |c}{geteg|id}{}.Re|
|00001380| 74 75 72 6e 20 74 68 65 | 20 63 75 72 72 65 6e 74 |turn the| current|
|00001390| 20 70 72 6f 63 65 73 73 | 27 73 20 65 66 66 65 63 | process|'s effec|
|000013a0| 74 69 76 65 20 67 72 6f | 75 70 20 69 64 2e 0d 28 |tive gro|up id..(|
|000013b0| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0d |Not on M|S-DOS.).|
|000013c0| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|000013d0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000013e0| 7b 67 65 74 65 75 69 64 | 7d 7b 7d 0d 52 65 74 75 |{geteuid|}{}.Retu|
|000013f0| 72 6e 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 70 |rn the c|urrent p|
|00001400| 72 6f 63 65 73 73 27 73 | 20 65 66 66 65 63 74 69 |rocess's| effecti|
|00001410| 76 65 20 75 73 65 72 20 | 69 64 2e 0d 28 4e 6f 74 |ve user |id..(Not|
|00001420| 20 6f 6e 20 4d 53 2d 44 | 4f 53 2e 29 0d 5c 65 6e | on MS-D|OS.).\en|
|00001430| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00001440| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 67 65 |gin{func|desc}{ge|
|00001450| 74 67 69 64 7d 7b 7d 0d | 52 65 74 75 72 6e 20 74 |tgid}{}.|Return t|
|00001460| 68 65 20 63 75 72 72 65 | 6e 74 20 70 72 6f 63 65 |he curre|nt proce|
|00001470| 73 73 27 73 20 67 72 6f | 75 70 20 69 64 2e 0d 28 |ss's gro|up id..(|
|00001480| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0d |Not on M|S-DOS.).|
|00001490| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|000014a0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000014b0| 7b 67 65 74 70 69 64 7d | 7b 7d 0d 52 65 74 75 72 |{getpid}|{}.Retur|
|000014c0| 6e 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 70 72 |n the cu|rrent pr|
|000014d0| 6f 63 65 73 73 20 69 64 | 2e 0d 28 4e 6f 74 20 6f |ocess id|..(Not o|
|000014e0| 6e 20 4d 53 2d 44 4f 53 | 2e 29 0d 5c 65 6e 64 7b |n MS-DOS|.).\end{|
|000014f0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00001500| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 67 65 74 70 |n{funcde|sc}{getp|
|00001510| 70 69 64 7d 7b 7d 0d 52 | 65 74 75 72 6e 20 74 68 |pid}{}.R|eturn th|
|00001520| 65 20 70 61 72 65 6e 74 | 27 73 20 70 72 6f 63 65 |e parent|'s proce|
|00001530| 73 73 20 69 64 2e 0d 28 | 4e 6f 74 20 6f 6e 20 4d |ss id..(|Not on M|
|00001540| 53 2d 44 4f 53 2e 29 0d | 5c 65 6e 64 7b 66 75 6e |S-DOS.).|\end{fun|
|00001550| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001560| 75 6e 63 64 65 73 63 7d | 7b 67 65 74 75 69 64 7d |uncdesc}|{getuid}|
|00001570| 7b 7d 0d 52 65 74 75 72 | 6e 20 74 68 65 20 63 75 |{}.Retur|n the cu|
|00001580| 72 72 65 6e 74 20 70 72 | 6f 63 65 73 73 27 73 20 |rrent pr|ocess's |
|00001590| 75 73 65 72 20 69 64 2e | 0d 28 4e 6f 74 20 6f 6e |user id.|.(Not on|
|000015a0| 20 4d 53 2d 44 4f 53 2e | 29 0d 5c 65 6e 64 7b 66 | MS-DOS.|).\end{f|
|000015b0| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000015c0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 6b 69 6c 6c 7d |{funcdes|c}{kill}|
|000015d0| 7b 70 69 64 5c 2c 20 73 | 69 67 7d 0d 4b 69 6c 6c |{pid\, s|ig}.Kill|
|000015e0| 20 74 68 65 20 70 72 6f | 63 65 73 73 20 5c 76 61 | the pro|cess \va|
|000015f0| 72 7b 70 69 64 7d 20 77 | 69 74 68 20 73 69 67 6e |r{pid} w|ith sign|
|00001600| 61 6c 20 5c 76 61 72 7b | 73 69 67 7d 2e 0d 28 4e |al \var{|sig}..(N|
|00001610| 6f 74 20 6f 6e 20 4d 53 | 2d 44 4f 53 2e 29 0d 5c |ot on MS|-DOS.).\|
|00001620| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00001630| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001640| 6c 69 6e 6b 7d 7b 73 72 | 63 5c 2c 20 64 73 74 7d |link}{sr|c\, dst}|
|00001650| 0d 43 72 65 61 74 65 20 | 61 20 68 61 72 64 20 6c |.Create |a hard l|
|00001660| 69 6e 6b 20 70 6f 69 6e | 74 69 6e 67 20 74 6f 20 |ink poin|ting to |
|00001670| 5c 76 61 72 7b 73 72 63 | 7d 20 6e 61 6d 65 64 20 |\var{src|} named |
|00001680| 5c 76 61 72 7b 64 73 74 | 7d 2e 0d 28 4e 6f 74 20 |\var{dst|}..(Not |
|00001690| 6f 6e 20 4d 53 2d 44 4f | 53 2e 29 0d 5c 65 6e 64 |on MS-DO|S.).\end|
|000016a0| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 5c 62 65 67 |{funcdes|c}..\beg|
|000016b0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 6c 69 73 |in{funcd|esc}{lis|
|000016c0| 74 64 69 72 7d 7b 70 61 | 74 68 7d 0d 52 65 74 75 |tdir}{pa|th}.Retu|
|000016d0| 72 6e 20 61 20 6c 69 73 | 74 20 63 6f 6e 74 61 69 |rn a lis|t contai|
|000016e0| 6e 69 6e 67 20 74 68 65 | 20 6e 61 6d 65 73 20 6f |ning the| names o|
|000016f0| 66 20 74 68 65 20 65 6e | 74 72 69 65 73 20 69 6e |f the en|tries in|
|00001700| 20 74 68 65 20 64 69 72 | 65 63 74 6f 72 79 2e 0d | the dir|ectory..|
|00001710| 54 68 65 20 6c 69 73 74 | 20 69 73 20 69 6e 20 61 |The list| is in a|
|00001720| 72 62 69 74 72 61 72 79 | 20 6f 72 64 65 72 2e 20 |rbitrary| order. |
|00001730| 20 49 74 20 69 6e 63 6c | 75 64 65 73 20 74 68 65 | It incl|udes the|
|00001740| 20 73 70 65 63 69 61 6c | 20 65 6e 74 72 69 65 73 | special| entries|
|00001750| 0d 5c 63 6f 64 65 7b 27 | 2e 27 7d 20 61 6e 64 20 |.\code{'|.'} and |
|00001760| 5c 63 6f 64 65 7b 27 2e | 2e 27 7d 20 69 66 20 74 |\code{'.|.'} if t|
|00001770| 68 65 79 20 61 72 65 20 | 70 72 65 73 65 6e 74 20 |hey are |present |
|00001780| 69 6e 20 74 68 65 20 64 | 69 72 65 63 74 6f 72 79 |in the d|irectory|
|00001790| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|000017a0| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000017b0| 63 7d 7b 6c 73 65 65 6b | 7d 7b 66 64 5c 2c 20 70 |c}{lseek|}{fd\, p|
|000017c0| 6f 73 5c 2c 20 68 6f 77 | 7d 0d 53 65 74 20 74 68 |os\, how|}.Set th|
|000017d0| 65 20 63 75 72 72 65 6e | 74 20 70 6f 73 69 74 69 |e curren|t positi|
|000017e0| 6f 6e 20 6f 66 20 66 69 | 6c 65 20 64 65 73 63 72 |on of fi|le descr|
|000017f0| 69 70 74 6f 72 20 5c 76 | 61 72 7b 66 64 7d 20 74 |iptor \v|ar{fd} t|
|00001800| 6f 20 70 6f 73 69 74 69 | 6f 6e 0d 5c 76 61 72 7b |o positi|on.\var{|
|00001810| 70 6f 73 7d 2c 20 6d 6f | 64 69 66 69 65 64 20 62 |pos}, mo|dified b|
|00001820| 79 20 5c 76 61 72 7b 68 | 6f 77 7d 3a 20 30 20 74 |y \var{h|ow}: 0 t|
|00001830| 6f 20 73 65 74 20 74 68 | 65 20 70 6f 73 69 74 69 |o set th|e positi|
|00001840| 6f 6e 20 72 65 6c 61 74 | 69 76 65 20 74 6f 0d 74 |on relat|ive to.t|
|00001850| 68 65 20 62 65 67 69 6e | 6e 69 6e 67 20 6f 66 20 |he begin|ning of |
|00001860| 74 68 65 20 66 69 6c 65 | 3b 20 31 20 74 6f 20 73 |the file|; 1 to s|
|00001870| 65 74 20 69 74 20 72 65 | 6c 61 74 69 76 65 20 74 |et it re|lative t|
|00001880| 6f 20 74 68 65 20 63 75 | 72 72 65 6e 74 0d 70 6f |o the cu|rrent.po|
|00001890| 73 69 74 69 6f 6e 3b 20 | 32 20 74 6f 20 73 65 74 |sition; |2 to set|
|000018a0| 20 69 74 20 72 65 6c 61 | 74 69 76 65 20 74 6f 20 | it rela|tive to |
|000018b0| 74 68 65 20 65 6e 64 20 | 6f 66 20 74 68 65 20 66 |the end |of the f|
|000018c0| 69 6c 65 2e 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ile..\en|d{funcde|
|000018d0| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000018e0| 64 65 73 63 7d 7b 6c 73 | 74 61 74 7d 7b 70 61 74 |desc}{ls|tat}{pat|
|000018f0| 68 7d 0d 4c 69 6b 65 20 | 5c 63 6f 64 65 7b 73 74 |h}.Like |\code{st|
|00001900| 61 74 28 29 7d 2c 20 62 | 75 74 20 64 6f 20 6e 6f |at()}, b|ut do no|
|00001910| 74 20 66 6f 6c 6c 6f 77 | 20 73 79 6d 62 6f 6c 69 |t follow| symboli|
|00001920| 63 20 6c 69 6e 6b 73 2e | 20 20 28 4f 6e 20 73 79 |c links.|  (On sy|
|00001930| 73 74 65 6d 73 0d 77 69 | 74 68 6f 75 74 20 73 79 |stems.wi|thout sy|
|00001940| 6d 62 6f 6c 69 63 20 6c | 69 6e 6b 73 2c 20 74 68 |mbolic l|inks, th|
|00001950| 69 73 20 69 73 20 69 64 | 65 6e 74 69 63 61 6c 20 |is is id|entical |
|00001960| 74 6f 20 5c 63 6f 64 65 | 7b 70 6f 73 69 78 2e 73 |to \code|{posix.s|
|00001970| 74 61 74 7d 2e 29 0d 5c | 65 6e 64 7b 66 75 6e 63 |tat}.).\|end{func|
|00001980| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00001990| 6e 63 64 65 73 63 7d 7b | 6d 6b 64 69 72 7d 7b 70 |ncdesc}{|mkdir}{p|
|000019a0| 61 74 68 5c 2c 20 6d 6f | 64 65 7d 0d 43 72 65 61 |ath\, mo|de}.Crea|
|000019b0| 74 65 20 61 20 64 69 72 | 65 63 74 6f 72 79 20 6e |te a dir|ectory n|
|000019c0| 61 6d 65 64 20 5c 76 61 | 72 7b 70 61 74 68 7d 20 |amed \va|r{path} |
|000019d0| 77 69 74 68 20 6e 75 6d | 65 72 69 63 20 6d 6f 64 |with num|eric mod|
|000019e0| 65 20 5c 76 61 72 7b 6d | 6f 64 65 7d 2e 0d 5c 65 |e \var{m|ode}..\e|
|000019f0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00001a00| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 6e |egin{fun|cdesc}{n|
|00001a10| 69 63 65 7d 7b 69 6e 63 | 72 65 6d 65 6e 74 7d 0d |ice}{inc|rement}.|
|00001a20| 41 64 64 20 5c 76 61 72 | 7b 69 6e 63 72 7d 20 74 |Add \var|{incr} t|
|00001a30| 6f 20 74 68 65 20 70 72 | 6f 63 65 73 73 27 20 60 |o the pr|ocess' `|
|00001a40| 60 6e 69 63 65 6e 65 73 | 73 27 27 2e 20 20 52 65 |`nicenes|s''.  Re|
|00001a50| 74 75 72 6e 20 74 68 65 | 20 6e 65 77 20 6e 69 63 |turn the| new nic|
|00001a60| 65 6e 65 73 73 2e 0d 28 | 4e 6f 74 20 6f 6e 20 4d |eness..(|Not on M|
|00001a70| 53 2d 44 4f 53 2e 29 0d | 5c 65 6e 64 7b 66 75 6e |S-DOS.).|\end{fun|
|00001a80| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001a90| 75 6e 63 64 65 73 63 7d | 7b 6f 70 65 6e 7d 7b 66 |uncdesc}|{open}{f|
|00001aa0| 69 6c 65 5c 2c 20 66 6c | 61 67 73 5c 2c 20 6d 6f |ile\, fl|ags\, mo|
|00001ab0| 64 65 7d 0d 4f 70 65 6e | 20 74 68 65 20 66 69 6c |de}.Open| the fil|
|00001ac0| 65 20 5c 76 61 72 7b 66 | 69 6c 65 7d 20 61 6e 64 |e \var{f|ile} and|
|00001ad0| 20 73 65 74 20 76 61 72 | 69 6f 75 73 20 66 6c 61 | set var|ious fla|
|00001ae0| 67 73 20 61 63 63 6f 72 | 64 69 6e 67 20 74 6f 0d |gs accor|ding to.|
|00001af0| 5c 76 61 72 7b 66 6c 61 | 67 73 7d 20 61 6e 64 20 |\var{fla|gs} and |
|00001b00| 70 6f 73 73 69 62 6c 79 | 20 69 74 73 20 6d 6f 64 |possibly| its mod|
|00001b10| 65 20 61 63 63 6f 72 64 | 69 6e 67 20 74 6f 20 5c |e accord|ing to \|
|00001b20| 76 61 72 7b 6d 6f 64 65 | 7d 2e 0d 52 65 74 75 72 |var{mode|}..Retur|
|00001b30| 6e 20 74 68 65 20 66 69 | 6c 65 20 64 65 73 63 72 |n the fi|le descr|
|00001b40| 69 70 74 6f 72 20 66 6f | 72 20 74 68 65 20 6e 65 |iptor fo|r the ne|
|00001b50| 77 6c 79 20 6f 70 65 6e | 65 64 20 66 69 6c 65 2e |wly open|ed file.|
|00001b60| 0d 0d 4e 6f 74 65 3a 20 | 74 68 69 73 20 66 75 6e |..Note: |this fun|
|00001b70| 63 74 69 6f 6e 20 69 73 | 20 69 6e 74 65 6e 64 65 |ction is| intende|
|00001b80| 64 20 66 6f 72 20 6c 6f | 77 2d 6c 65 76 65 6c 20 |d for lo|w-level |
|00001b90| 49 2f 4f 2e 20 20 46 6f | 72 20 6e 6f 72 6d 61 6c |I/O.  Fo|r normal|
|00001ba0| 20 75 73 61 67 65 2c 0d | 75 73 65 20 74 68 65 20 | usage,.|use the |
|00001bb0| 62 75 69 6c 74 2d 69 6e | 20 66 75 6e 63 74 69 6f |built-in| functio|
|00001bc0| 6e 20 5c 63 6f 64 65 7b | 6f 70 65 6e 7d 2c 20 77 |n \code{|open}, w|
|00001bd0| 68 69 63 68 20 72 65 74 | 75 72 6e 73 20 61 20 60 |hich ret|urns a `|
|00001be0| 60 66 69 6c 65 20 6f 62 | 6a 65 63 74 27 27 0d 77 |`file ob|ject''.w|
|00001bf0| 69 74 68 20 5c 63 6f 64 | 65 7b 72 65 61 64 28 29 |ith \cod|e{read()|
|00001c00| 7d 20 61 6e 64 20 20 5c | 63 6f 64 65 7b 77 72 69 |} and  \|code{wri|
|00001c10| 74 65 28 29 7d 20 6d 65 | 74 68 6f 64 73 20 28 61 |te()} me|thods (a|
|00001c20| 6e 64 20 6d 61 6e 79 20 | 6d 6f 72 65 29 2e 0d 5c |nd many |more)..\|
|00001c30| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00001c40| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001c50| 70 69 70 65 7d 7b 7d 0d | 43 72 65 61 74 65 20 61 |pipe}{}.|Create a|
|00001c60| 20 70 69 70 65 2e 20 20 | 52 65 74 75 72 6e 20 61 | pipe.  |Return a|
|00001c70| 20 70 61 69 72 20 6f 66 | 20 66 69 6c 65 20 64 65 | pair of| file de|
|00001c80| 73 63 72 69 70 74 6f 72 | 73 20 5c 63 6f 64 65 7b |scriptor|s \code{|
|00001c90| 28 72 2c 20 77 29 7d 0d | 75 73 61 62 6c 65 20 66 |(r, w)}.|usable f|
|00001ca0| 6f 72 20 72 65 61 64 69 | 6e 67 20 61 6e 64 20 77 |or readi|ng and w|
|00001cb0| 72 69 74 69 6e 67 2c 20 | 72 65 73 70 65 63 74 69 |riting, |respecti|
|00001cc0| 76 65 6c 79 2e 0d 28 4e | 6f 74 20 6f 6e 20 4d 53 |vely..(N|ot on MS|
|00001cd0| 2d 44 4f 53 2e 29 0d 5c | 65 6e 64 7b 66 75 6e 63 |-DOS.).\|end{func|
|00001ce0| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00001cf0| 6e 63 64 65 73 63 7d 7b | 70 6f 70 65 6e 7d 7b 63 |ncdesc}{|popen}{c|
|00001d00| 6f 6d 6d 61 6e 64 5c 6f | 70 74 69 6f 6e 61 6c 7b |ommand\o|ptional{|
|00001d10| 5c 2c 20 6d 6f 64 65 5c | 6f 70 74 69 6f 6e 61 6c |\, mode\|optional|
|00001d20| 7b 5c 2c 20 62 75 66 73 | 69 7a 65 7d 7d 7d 0d 4f |{\, bufs|ize}}}.O|
|00001d30| 70 65 6e 20 61 20 70 69 | 70 65 20 74 6f 20 6f 72 |pen a pi|pe to or|
|00001d40| 20 66 72 6f 6d 20 5c 76 | 61 72 7b 63 6f 6d 6d 61 | from \v|ar{comma|
|00001d50| 6e 64 7d 2e 20 20 54 68 | 65 20 72 65 74 75 72 6e |nd}.  Th|e return|
|00001d60| 20 76 61 6c 75 65 20 69 | 73 20 61 6e 20 6f 70 65 | value i|s an ope|
|00001d70| 6e 0d 66 69 6c 65 20 6f | 62 6a 65 63 74 20 63 6f |n.file o|bject co|
|00001d80| 6e 6e 65 63 74 65 64 20 | 74 6f 20 74 68 65 20 70 |nnected |to the p|
|00001d90| 69 70 65 2c 20 77 68 69 | 63 68 20 63 61 6e 20 62 |ipe, whi|ch can b|
|00001da0| 65 20 72 65 61 64 20 6f | 72 20 77 72 69 74 74 65 |e read o|r writte|
|00001db0| 6e 0d 64 65 70 65 6e 64 | 69 6e 67 20 6f 6e 20 77 |n.depend|ing on w|
|00001dc0| 68 65 74 68 65 72 20 5c | 76 61 72 7b 6d 6f 64 65 |hether \|var{mode|
|00001dd0| 7d 20 69 73 20 5c 63 6f | 64 65 7b 27 72 27 7d 20 |} is \co|de{'r'} |
|00001de0| 28 64 65 66 61 75 6c 74 | 29 20 6f 72 20 5c 63 6f |(default|) or \co|
|00001df0| 64 65 7b 27 77 27 7d 2e | 0d 54 68 65 20 5c 76 61 |de{'w'}.|.The \va|
|00001e00| 72 7b 62 75 66 73 69 7a | 65 7d 20 61 72 67 75 6d |r{bufsiz|e} argum|
|00001e10| 65 6e 74 20 68 61 73 20 | 74 68 65 20 73 61 6d 65 |ent has |the same|
|00001e20| 20 6d 65 61 6e 69 6e 67 | 20 61 73 20 74 68 65 20 | meaning| as the |
|00001e30| 63 6f 72 72 65 73 70 6f | 6e 64 69 6e 67 0d 61 72 |correspo|nding.ar|
|00001e40| 67 75 6d 65 6e 74 20 74 | 6f 20 74 68 65 20 62 75 |gument t|o the bu|
|00001e50| 69 6c 74 2d 69 6e 20 5c | 63 6f 64 65 7b 6f 70 65 |ilt-in \|code{ope|
|00001e60| 6e 28 29 7d 20 66 75 6e | 63 74 69 6f 6e 2e 0d 28 |n()} fun|ction..(|
|00001e70| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0d |Not on M|S-DOS.).|
|00001e80| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00001e90| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00001ea0| 7b 72 65 61 64 7d 7b 66 | 64 5c 2c 20 6e 7d 0d 52 |{read}{f|d\, n}.R|
|00001eb0| 65 61 64 20 61 74 20 6d | 6f 73 74 20 5c 76 61 72 |ead at m|ost \var|
|00001ec0| 7b 6e 7d 20 62 79 74 65 | 73 20 66 72 6f 6d 20 66 |{n} byte|s from f|
|00001ed0| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 5c |ile desc|riptor \|
|00001ee0| 76 61 72 7b 66 64 7d 2e | 0d 52 65 74 75 72 6e 20 |var{fd}.|.Return |
|00001ef0| 61 20 73 74 72 69 6e 67 | 20 63 6f 6e 74 61 69 6e |a string| contain|
|00001f00| 69 6e 67 20 74 68 65 20 | 62 79 74 65 73 20 72 65 |ing the |bytes re|
|00001f10| 61 64 2e 0d 0d 4e 6f 74 | 65 3a 20 74 68 69 73 20 |ad...Not|e: this |
|00001f20| 66 75 6e 63 74 69 6f 6e | 20 69 73 20 69 6e 74 65 |function| is inte|
|00001f30| 6e 64 65 64 20 66 6f 72 | 20 6c 6f 77 2d 6c 65 76 |nded for| low-lev|
|00001f40| 65 6c 20 49 2f 4f 20 61 | 6e 64 20 6d 75 73 74 20 |el I/O a|nd must |
|00001f50| 62 65 20 61 70 70 6c 69 | 65 64 0d 74 6f 20 61 20 |be appli|ed.to a |
|00001f60| 66 69 6c 65 20 64 65 73 | 63 72 69 70 74 6f 72 20 |file des|criptor |
|00001f70| 61 73 20 72 65 74 75 72 | 6e 65 64 20 62 79 20 5c |as retur|ned by \|
|00001f80| 63 6f 64 65 7b 70 6f 73 | 69 78 2e 6f 70 65 6e 28 |code{pos|ix.open(|
|00001f90| 29 7d 20 6f 72 0d 5c 63 | 6f 64 65 7b 70 6f 73 69 |)} or.\c|ode{posi|
|00001fa0| 78 2e 70 69 70 65 28 29 | 7d 2e 20 20 54 6f 20 72 |x.pipe()|}.  To r|
|00001fb0| 65 61 64 20 61 20 60 60 | 66 69 6c 65 20 6f 62 6a |ead a ``|file obj|
|00001fc0| 65 63 74 27 27 20 72 65 | 74 75 72 6e 65 64 20 62 |ect'' re|turned b|
|00001fd0| 79 20 74 68 65 0d 62 75 | 69 6c 74 2d 69 6e 20 66 |y the.bu|ilt-in f|
|00001fe0| 75 6e 63 74 69 6f 6e 20 | 5c 63 6f 64 65 7b 6f 70 |unction |\code{op|
|00001ff0| 65 6e 7d 20 6f 72 20 62 | 79 20 5c 63 6f 64 65 7b |en} or b|y \code{|
|00002000| 70 6f 73 69 78 2e 70 6f | 70 65 6e 7d 20 6f 72 0d |posix.po|pen} or.|
|00002010| 5c 63 6f 64 65 7b 70 6f | 73 69 78 2e 66 64 6f 70 |\code{po|six.fdop|
|00002020| 65 6e 7d 2c 20 6f 72 20 | 5c 63 6f 64 65 7b 73 79 |en}, or |\code{sy|
|00002030| 73 2e 73 74 64 69 6e 7d | 2c 20 75 73 65 20 69 74 |s.stdin}|, use it|
|00002040| 73 0d 5c 63 6f 64 65 7b | 72 65 61 64 28 29 7d 20 |s.\code{|read()} |
|00002050| 6f 72 20 5c 63 6f 64 65 | 7b 72 65 61 64 6c 69 6e |or \code|{readlin|
|00002060| 65 28 29 7d 20 6d 65 74 | 68 6f 64 73 2e 0d 5c 65 |e()} met|hods..\e|
|00002070| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00002080| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 72 |egin{fun|cdesc}{r|
|00002090| 65 61 64 6c 69 6e 6b 7d | 7b 70 61 74 68 7d 0d 52 |eadlink}|{path}.R|
|000020a0| 65 74 75 72 6e 20 61 20 | 73 74 72 69 6e 67 20 72 |eturn a |string r|
|000020b0| 65 70 72 65 73 65 6e 74 | 69 6e 67 20 74 68 65 20 |epresent|ing the |
|000020c0| 70 61 74 68 20 74 6f 20 | 77 68 69 63 68 20 74 68 |path to |which th|
|000020d0| 65 20 73 79 6d 62 6f 6c | 69 63 20 6c 69 6e 6b 0d |e symbol|ic link.|
|000020e0| 70 6f 69 6e 74 73 2e 20 | 20 28 4f 6e 20 73 79 73 |points. | (On sys|
|000020f0| 74 65 6d 73 20 77 69 74 | 68 6f 75 74 20 73 79 6d |tems wit|hout sym|
|00002100| 62 6f 6c 69 63 20 6c 69 | 6e 6b 73 2c 20 74 68 69 |bolic li|nks, thi|
|00002110| 73 20 61 6c 77 61 79 73 | 20 72 61 69 73 65 73 0d |s always| raises.|
|00002120| 5c 63 6f 64 65 7b 70 6f | 73 69 78 2e 65 72 72 6f |\code{po|six.erro|
|00002130| 72 7d 2e 29 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |r}.).\en|d{funcde|
|00002140| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00002150| 64 65 73 63 7d 7b 72 65 | 6e 61 6d 65 7d 7b 73 72 |desc}{re|name}{sr|
|00002160| 63 5c 2c 20 64 73 74 7d | 0d 52 65 6e 61 6d 65 20 |c\, dst}|.Rename |
|00002170| 74 68 65 20 66 69 6c 65 | 20 6f 72 20 64 69 72 65 |the file| or dire|
|00002180| 63 74 6f 72 79 20 5c 76 | 61 72 7b 73 72 63 7d 20 |ctory \v|ar{src} |
|00002190| 74 6f 20 5c 76 61 72 7b | 64 73 74 7d 2e 0d 5c 65 |to \var{|dst}..\e|
|000021a0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|000021b0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 72 |egin{fun|cdesc}{r|
|000021c0| 6d 64 69 72 7d 7b 70 61 | 74 68 7d 0d 52 65 6d 6f |mdir}{pa|th}.Remo|
|000021d0| 76 65 20 74 68 65 20 64 | 69 72 65 63 74 6f 72 79 |ve the d|irectory|
|000021e0| 20 5c 76 61 72 7b 70 61 | 74 68 7d 2e 0d 5c 65 6e | \var{pa|th}..\en|
|000021f0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00002200| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 73 65 |gin{func|desc}{se|
|00002210| 74 67 69 64 7d 7b 67 69 | 64 7d 0d 53 65 74 20 74 |tgid}{gi|d}.Set t|
|00002220| 68 65 20 63 75 72 72 65 | 6e 74 20 70 72 6f 63 65 |he curre|nt proce|
|00002230| 73 73 27 73 20 67 72 6f | 75 70 20 69 64 2e 0d 28 |ss's gro|up id..(|
|00002240| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0d |Not on M|S-DOS.).|
|00002250| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00002260| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00002270| 7b 73 65 74 75 69 64 7d | 7b 75 69 64 7d 0d 53 65 |{setuid}|{uid}.Se|
|00002280| 74 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 70 72 |t the cu|rrent pr|
|00002290| 6f 63 65 73 73 27 73 20 | 75 73 65 72 20 69 64 2e |ocess's |user id.|
|000022a0| 0d 28 4e 6f 74 20 6f 6e | 20 4d 53 2d 44 4f 53 2e |.(Not on| MS-DOS.|
|000022b0| 29 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|000022c0| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000022d0| 63 7d 7b 73 74 61 74 7d | 7b 70 61 74 68 7d 0d 50 |c}{stat}|{path}.P|
|000022e0| 65 72 66 6f 72 6d 20 61 | 20 7b 5c 65 6d 20 73 74 |erform a| {\em st|
|000022f0| 61 74 7d 20 73 79 73 74 | 65 6d 20 63 61 6c 6c 20 |at} syst|em call |
|00002300| 6f 6e 20 74 68 65 20 67 | 69 76 65 6e 20 70 61 74 |on the g|iven pat|
|00002310| 68 2e 20 20 54 68 65 20 | 72 65 74 75 72 6e 20 76 |h.  The |return v|
|00002320| 61 6c 75 65 0d 69 73 20 | 61 20 74 75 70 6c 65 20 |alue.is |a tuple |
|00002330| 6f 66 20 61 74 20 6c 65 | 61 73 74 20 31 30 20 69 |of at le|ast 10 i|
|00002340| 6e 74 65 67 65 72 73 20 | 67 69 76 69 6e 67 20 74 |ntegers |giving t|
|00002350| 68 65 20 6d 6f 73 74 20 | 69 6d 70 6f 72 74 61 6e |he most |importan|
|00002360| 74 20 28 61 6e 64 0d 70 | 6f 72 74 61 62 6c 65 29 |t (and.p|ortable)|
|00002370| 20 6d 65 6d 62 65 72 73 | 20 6f 66 20 74 68 65 20 | members| of the |
|00002380| 7b 5c 65 6d 20 73 74 61 | 74 7d 20 73 74 72 75 63 |{\em sta|t} struc|
|00002390| 74 75 72 65 2c 20 69 6e | 20 74 68 65 20 6f 72 64 |ture, in| the ord|
|000023a0| 65 72 0d 5c 63 6f 64 65 | 7b 73 74 5f 6d 6f 64 65 |er.\code|{st_mode|
|000023b0| 7d 2c 0d 5c 63 6f 64 65 | 7b 73 74 5f 69 6e 6f 7d |},.\code|{st_ino}|
|000023c0| 2c 0d 5c 63 6f 64 65 7b | 73 74 5f 64 65 76 7d 2c |,.\code{|st_dev},|
|000023d0| 0d 5c 63 6f 64 65 7b 73 | 74 5f 6e 6c 69 6e 6b 7d |.\code{s|t_nlink}|
|000023e0| 2c 0d 5c 63 6f 64 65 7b | 73 74 5f 75 69 64 7d 2c |,.\code{|st_uid},|
|000023f0| 0d 5c 63 6f 64 65 7b 73 | 74 5f 67 69 64 7d 2c 0d |.\code{s|t_gid},.|
|00002400| 5c 63 6f 64 65 7b 73 74 | 5f 73 69 7a 65 7d 2c 0d |\code{st|_size},.|
|00002410| 5c 63 6f 64 65 7b 73 74 | 5f 61 74 69 6d 65 7d 2c |\code{st|_atime},|
|00002420| 0d 5c 63 6f 64 65 7b 73 | 74 5f 6d 74 69 6d 65 7d |.\code{s|t_mtime}|
|00002430| 2c 0d 5c 63 6f 64 65 7b | 73 74 5f 63 74 69 6d 65 |,.\code{|st_ctime|
|00002440| 7d 2e 0d 4d 6f 72 65 20 | 69 74 65 6d 73 20 6d 61 |}..More |items ma|
|00002450| 79 20 62 65 20 61 64 64 | 65 64 20 61 74 20 74 68 |y be add|ed at th|
|00002460| 65 20 65 6e 64 20 62 79 | 20 73 6f 6d 65 20 69 6d |e end by| some im|
|00002470| 70 6c 65 6d 65 6e 74 61 | 74 69 6f 6e 73 2e 0d 28 |plementa|tions..(|
|00002480| 4f 6e 20 4d 53 2d 44 4f | 53 2c 20 73 6f 6d 65 20 |On MS-DO|S, some |
|00002490| 69 74 65 6d 73 20 61 72 | 65 20 66 69 6c 6c 65 64 |items ar|e filled|
|000024a0| 20 77 69 74 68 20 64 75 | 6d 6d 79 20 76 61 6c 75 | with du|mmy valu|
|000024b0| 65 73 2e 29 0d 0d 4e 6f | 74 65 3a 20 54 68 65 20 |es.)..No|te: The |
|000024c0| 73 74 61 6e 64 61 72 64 | 20 6d 6f 64 75 6c 65 20 |standard| module |
|000024d0| 5c 63 6f 64 65 7b 73 74 | 61 74 7d 20 64 65 66 69 |\code{st|at} defi|
|000024e0| 6e 65 73 20 66 75 6e 63 | 74 69 6f 6e 73 20 61 6e |nes func|tions an|
|000024f0| 64 20 63 6f 6e 73 74 61 | 6e 74 73 0d 74 68 61 74 |d consta|nts.that|
|00002500| 20 61 72 65 20 75 73 65 | 66 75 6c 20 66 6f 72 20 | are use|ful for |
|00002510| 65 78 74 72 61 63 74 69 | 6e 67 20 69 6e 66 6f 72 |extracti|ng infor|
|00002520| 6d 61 74 69 6f 6e 20 66 | 72 6f 6d 20 61 20 73 74 |mation f|rom a st|
|00002530| 61 74 20 73 74 72 75 63 | 74 75 72 65 2e 0d 5c 65 |at struc|ture..\e|
|00002540| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00002550| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00002560| 79 6d 6c 69 6e 6b 7d 7b | 73 72 63 5c 2c 20 64 73 |ymlink}{|src\, ds|
|00002570| 74 7d 0d 43 72 65 61 74 | 65 20 61 20 73 79 6d 62 |t}.Creat|e a symb|
|00002580| 6f 6c 69 63 20 6c 69 6e | 6b 20 70 6f 69 6e 74 69 |olic lin|k pointi|
|00002590| 6e 67 20 74 6f 20 5c 76 | 61 72 7b 73 72 63 7d 20 |ng to \v|ar{src} |
|000025a0| 6e 61 6d 65 64 20 5c 76 | 61 72 7b 64 73 74 7d 2e |named \v|ar{dst}.|
|000025b0| 20 20 28 4f 6e 0d 73 79 | 73 74 65 6d 73 20 77 69 |  (On.sy|stems wi|
|000025c0| 74 68 6f 75 74 20 73 79 | 6d 62 6f 6c 69 63 20 6c |thout sy|mbolic l|
|000025d0| 69 6e 6b 73 2c 20 74 68 | 69 73 20 61 6c 77 61 79 |inks, th|is alway|
|000025e0| 73 20 72 61 69 73 65 73 | 0d 5c 63 6f 64 65 7b 70 |s raises|.\code{p|
|000025f0| 6f 73 69 78 2e 65 72 72 | 6f 72 7d 2e 29 0d 5c 65 |osix.err|or}.).\e|
|00002600| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00002610| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00002620| 79 73 74 65 6d 7d 7b 63 | 6f 6d 6d 61 6e 64 7d 0d |ystem}{c|ommand}.|
|00002630| 45 78 65 63 75 74 65 20 | 74 68 65 20 63 6f 6d 6d |Execute |the comm|
|00002640| 61 6e 64 20 28 61 20 73 | 74 72 69 6e 67 29 20 69 |and (a s|tring) i|
|00002650| 6e 20 61 20 73 75 62 73 | 68 65 6c 6c 2e 20 20 54 |n a subs|hell.  T|
|00002660| 68 69 73 20 69 73 20 69 | 6d 70 6c 65 6d 65 6e 74 |his is i|mplement|
|00002670| 65 64 20 62 79 0d 63 61 | 6c 6c 69 6e 67 20 74 68 |ed by.ca|lling th|
|00002680| 65 20 53 74 61 6e 64 61 | 72 64 20 43 20 66 75 6e |e Standa|rd C fun|
|00002690| 63 74 69 6f 6e 20 5c 63 | 6f 64 65 7b 73 79 73 74 |ction \c|ode{syst|
|000026a0| 65 6d 28 29 7d 2c 20 61 | 6e 64 20 68 61 73 20 74 |em()}, a|nd has t|
|000026b0| 68 65 20 73 61 6d 65 0d | 6c 69 6d 69 74 61 74 69 |he same.|limitati|
|000026c0| 6f 6e 73 2e 20 20 43 68 | 61 6e 67 65 73 20 74 6f |ons.  Ch|anges to|
|000026d0| 20 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 65 6e 76 | \code{p|osix.env|
|000026e0| 69 72 6f 6e 7d 2c 20 5c | 63 6f 64 65 7b 73 79 73 |iron}, \|code{sys|
|000026f0| 2e 73 74 64 69 6e 7d 20 | 65 74 63 2e 5c 20 61 72 |.stdin} |etc.\ ar|
|00002700| 65 0d 6e 6f 74 20 72 65 | 66 6c 65 63 74 65 64 20 |e.not re|flected |
|00002710| 69 6e 20 74 68 65 20 65 | 6e 76 69 72 6f 6e 6d 65 |in the e|nvironme|
|00002720| 6e 74 20 6f 66 20 74 68 | 65 20 65 78 65 63 75 74 |nt of th|e execut|
|00002730| 65 64 20 63 6f 6d 6d 61 | 6e 64 2e 20 20 54 68 65 |ed comma|nd.  The|
|00002740| 20 72 65 74 75 72 6e 0d | 76 61 6c 75 65 20 69 73 | return.|value is|
|00002750| 20 74 68 65 20 65 78 69 | 74 20 73 74 61 74 75 73 | the exi|t status|
|00002760| 20 6f 66 20 74 68 65 20 | 70 72 6f 63 65 73 73 20 | of the |process |
|00002770| 61 73 20 72 65 74 75 72 | 6e 65 64 20 62 79 20 53 |as retur|ned by S|
|00002780| 74 61 6e 64 61 72 64 20 | 43 0d 5c 63 6f 64 65 7b |tandard |C.\code{|
|00002790| 73 79 73 74 65 6d 28 29 | 7d 2e 0d 5c 65 6e 64 7b |system()|}..\end{|
|000027a0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|000027b0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 74 69 6d 65 |n{funcde|sc}{time|
|000027c0| 73 7d 7b 7d 0d 52 65 74 | 75 72 6e 20 61 20 35 2d |s}{}.Ret|urn a 5-|
|000027d0| 74 75 70 6c 65 20 6f 66 | 20 66 6c 6f 61 74 69 6e |tuple of| floatin|
|000027e0| 67 20 70 6f 69 6e 74 20 | 6e 75 6d 62 65 72 73 20 |g point |numbers |
|000027f0| 69 6e 64 69 63 61 74 69 | 6e 67 20 61 63 63 75 6d |indicati|ng accum|
|00002800| 75 6c 61 74 65 64 20 28 | 43 50 55 0d 6f 72 20 6f |ulated (|CPU.or o|
|00002810| 74 68 65 72 29 0d 74 69 | 6d 65 73 2c 20 69 6e 20 |ther).ti|mes, in |
|00002820| 73 65 63 6f 6e 64 73 2e | 20 20 54 68 65 20 69 74 |seconds.|  The it|
|00002830| 65 6d 73 20 61 72 65 3a | 20 75 73 65 72 20 74 69 |ems are:| user ti|
|00002840| 6d 65 2c 20 73 79 73 74 | 65 6d 20 74 69 6d 65 2c |me, syst|em time,|
|00002850| 20 63 68 69 6c 64 72 65 | 6e 27 73 0d 75 73 65 72 | childre|n's.user|
|00002860| 20 74 69 6d 65 2c 20 63 | 68 69 6c 64 72 65 6e 27 | time, c|hildren'|
|00002870| 73 20 73 79 73 74 65 6d | 20 74 69 6d 65 2c 20 61 |s system| time, a|
|00002880| 6e 64 20 65 6c 61 70 73 | 65 64 20 72 65 61 6c 20 |nd elaps|ed real |
|00002890| 74 69 6d 65 20 73 69 6e | 63 65 20 61 20 66 69 78 |time sin|ce a fix|
|000028a0| 65 64 0d 70 6f 69 6e 74 | 20 69 6e 20 74 68 65 20 |ed.point| in the |
|000028b0| 70 61 73 74 2c 20 69 6e | 20 74 68 61 74 20 6f 72 |past, in| that or|
|000028c0| 64 65 72 2e 20 20 53 65 | 65 20 74 68 65 20 5c 55 |der.  Se|e the \U|
|000028d0| 4e 49 58 7b 7d 0d 6d 61 | 6e 75 61 6c 20 70 61 67 |NIX{}.ma|nual pag|
|000028e0| 65 20 7b 5c 69 74 20 74 | 69 6d 65 73 7d 28 32 29 |e {\it t|imes}(2)|
|000028f0| 2e 20 20 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |.  (Not |on MS-DO|
|00002900| 53 2e 29 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |S.).\end|{funcdes|
|00002910| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00002920| 65 73 63 7d 7b 75 6d 61 | 73 6b 7d 7b 6d 61 73 6b |esc}{uma|sk}{mask|
|00002930| 7d 0d 53 65 74 20 74 68 | 65 20 63 75 72 72 65 6e |}.Set th|e curren|
|00002940| 74 20 6e 75 6d 65 72 69 | 63 20 75 6d 61 73 6b 20 |t numeri|c umask |
|00002950| 61 6e 64 20 72 65 74 75 | 72 6e 73 20 74 68 65 20 |and retu|rns the |
|00002960| 70 72 65 76 69 6f 75 73 | 20 75 6d 61 73 6b 2e 0d |previous| umask..|
|00002970| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00002980| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00002990| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000029a0| 7d 7b 75 6e 61 6d 65 7d | 7b 7d 0d 52 65 74 75 72 |}{uname}|{}.Retur|
|000029b0| 6e 20 61 20 35 2d 74 75 | 70 6c 65 20 63 6f 6e 74 |n a 5-tu|ple cont|
|000029c0| 61 69 6e 69 6e 67 20 69 | 6e 66 6f 72 6d 61 74 69 |aining i|nformati|
|000029d0| 6f 6e 20 69 64 65 6e 74 | 69 66 79 69 6e 67 20 74 |on ident|ifying t|
|000029e0| 68 65 20 63 75 72 72 65 | 6e 74 0d 6f 70 65 72 61 |he curre|nt.opera|
|000029f0| 74 69 6e 67 20 73 79 73 | 74 65 6d 2e 20 20 54 68 |ting sys|tem.  Th|
|00002a00| 65 20 74 75 70 6c 65 20 | 63 6f 6e 74 61 69 6e 73 |e tuple |contains|
|00002a10| 20 35 20 73 74 72 69 6e | 67 73 3a 0d 5c 63 6f 64 | 5 strin|gs:.\cod|
|00002a20| 65 7b 28 5c 76 61 72 7b | 73 79 73 6e 61 6d 65 7d |e{(\var{|sysname}|
|00002a30| 2c 20 5c 76 61 72 7b 6e | 6f 64 65 6e 61 6d 65 7d |, \var{n|odename}|
|00002a40| 2c 20 5c 76 61 72 7b 72 | 65 6c 65 61 73 65 7d 2c |, \var{r|elease},|
|00002a50| 20 5c 76 61 72 7b 76 65 | 72 73 69 6f 6e 7d 2c 20 | \var{ve|rsion}, |
|00002a60| 5c 76 61 72 7b 6d 61 63 | 68 69 6e 65 7d 29 7d 2e |\var{mac|hine})}.|
|00002a70| 0d 53 6f 6d 65 20 73 79 | 73 74 65 6d 73 20 74 72 |.Some sy|stems tr|
|00002a80| 75 6e 63 61 74 65 20 74 | 68 65 20 6e 6f 64 65 6e |uncate t|he noden|
|00002a90| 61 6d 65 20 74 6f 20 38 | 0d 63 68 61 72 61 63 74 |ame to 8|.charact|
|00002aa0| 65 72 73 20 6f 72 20 74 | 6f 20 74 68 65 20 6c 65 |ers or t|o the le|
|00002ab0| 61 64 69 6e 67 20 63 6f | 6d 70 6f 6e 65 6e 74 3b |ading co|mponent;|
|00002ac0| 20 61 20 62 65 74 74 65 | 72 20 77 61 79 20 74 6f | a bette|r way to|
|00002ad0| 20 67 65 74 20 74 68 65 | 0d 68 6f 73 74 6e 61 6d | get the|.hostnam|
|00002ae0| 65 20 69 73 20 5c 63 6f | 64 65 7b 73 6f 63 6b 65 |e is \co|de{socke|
|00002af0| 74 2e 67 65 74 68 6f 73 | 74 6e 61 6d 65 28 29 7d |t.gethos|tname()}|
|00002b00| 2e 20 20 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |.  (Not |on MS-DO|
|00002b10| 53 2c 20 6e 6f 72 20 6f | 6e 20 6f 6c 64 65 72 0d |S, nor o|n older.|
|00002b20| 5c 55 4e 49 58 7b 7d 20 | 73 79 73 74 65 6d 73 2e |\UNIX{} |systems.|
|00002b30| 29 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|00002b40| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00002b50| 63 7d 7b 75 6e 6c 69 6e | 6b 7d 7b 70 61 74 68 7d |c}{unlin|k}{path}|
|00002b60| 0d 55 6e 6c 69 6e 6b 20 | 5c 76 61 72 7b 70 61 74 |.Unlink |\var{pat|
|00002b70| 68 7d 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |h}..\end|{funcdes|
|00002b80| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00002b90| 65 73 63 7d 7b 75 74 69 | 6d 65 7d 7b 70 61 74 68 |esc}{uti|me}{path|
|00002ba0| 5c 2c 20 5c 28 61 74 69 | 6d 65 5c 2c 20 6d 74 69 |\, \(ati|me\, mti|
|00002bb0| 6d 65 5c 29 7d 0d 53 65 | 74 20 74 68 65 20 61 63 |me\)}.Se|t the ac|
|00002bc0| 63 65 73 73 20 61 6e 64 | 20 6d 6f 64 69 66 69 65 |cess and| modifie|
|00002bd0| 64 20 74 69 6d 65 20 6f | 66 20 74 68 65 20 66 69 |d time o|f the fi|
|00002be0| 6c 65 20 74 6f 20 74 68 | 65 20 67 69 76 65 6e 20 |le to th|e given |
|00002bf0| 76 61 6c 75 65 73 2e 0d | 28 54 68 65 20 73 65 63 |values..|(The sec|
|00002c00| 6f 6e 64 20 61 72 67 75 | 6d 65 6e 74 20 69 73 20 |ond argu|ment is |
|00002c10| 61 20 74 75 70 6c 65 20 | 6f 66 20 74 77 6f 20 69 |a tuple |of two i|
|00002c20| 74 65 6d 73 2e 29 0d 5c | 65 6e 64 7b 66 75 6e 63 |tems.).\|end{func|
|00002c30| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00002c40| 6e 63 64 65 73 63 7d 7b | 77 61 69 74 7d 7b 7d 0d |ncdesc}{|wait}{}.|
|00002c50| 57 61 69 74 20 66 6f 72 | 20 63 6f 6d 70 6c 65 74 |Wait for| complet|
|00002c60| 69 6f 6e 20 6f 66 20 61 | 20 63 68 69 6c 64 20 70 |ion of a| child p|
|00002c70| 72 6f 63 65 73 73 2c 20 | 61 6e 64 20 72 65 74 75 |rocess, |and retu|
|00002c80| 72 6e 20 61 20 74 75 70 | 6c 65 20 63 6f 6e 74 61 |rn a tup|le conta|
|00002c90| 69 6e 69 6e 67 0d 69 74 | 73 20 70 69 64 20 61 6e |ining.it|s pid an|
|00002ca0| 64 20 65 78 69 74 20 73 | 74 61 74 75 73 20 69 6e |d exit s|tatus in|
|00002cb0| 64 69 63 61 74 69 6f 6e | 20 28 65 6e 63 6f 64 65 |dication| (encode|
|00002cc0| 64 20 61 73 20 62 79 20 | 5c 55 4e 49 58 7b 7d 29 |d as by |\UNIX{})|
|00002cd0| 2e 0d 28 4e 6f 74 20 6f | 6e 20 4d 53 2d 44 4f 53 |..(Not o|n MS-DOS|
|00002ce0| 2e 29 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |.).\end{|funcdesc|
|00002cf0| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00002d00| 73 63 7d 7b 77 61 69 74 | 70 69 64 7d 7b 70 69 64 |sc}{wait|pid}{pid|
|00002d10| 5c 2c 20 6f 70 74 69 6f | 6e 73 7d 0d 57 61 69 74 |\, optio|ns}.Wait|
|00002d20| 20 66 6f 72 20 63 6f 6d | 70 6c 65 74 69 6f 6e 20 | for com|pletion |
|00002d30| 6f 66 20 61 20 63 68 69 | 6c 64 20 70 72 6f 63 65 |of a chi|ld proce|
|00002d40| 73 73 20 67 69 76 65 6e | 20 62 79 20 70 72 6f 63 |ss given| by proc|
|00002d50| 65 73 20 69 64 2c 20 61 | 6e 64 20 72 65 74 75 72 |es id, a|nd retur|
|00002d60| 6e 0d 61 20 74 75 70 6c | 65 20 63 6f 6e 74 61 69 |n.a tupl|e contai|
|00002d70| 6e 69 6e 67 20 69 74 73 | 20 70 69 64 20 61 6e 64 |ning its| pid and|
|00002d80| 20 65 78 69 74 20 73 74 | 61 74 75 73 20 69 6e 64 | exit st|atus ind|
|00002d90| 69 63 61 74 69 6f 6e 20 | 28 65 6e 63 6f 64 65 64 |ication |(encoded|
|00002da0| 20 61 73 20 62 79 0d 5c | 55 4e 49 58 7b 7d 29 2e | as by.\|UNIX{}).|
|00002db0| 20 20 54 68 65 20 73 65 | 6d 61 6e 74 69 63 73 20 |  The se|mantics |
|00002dc0| 6f 66 20 74 68 65 20 63 | 61 6c 6c 20 61 72 65 20 |of the c|all are |
|00002dd0| 61 66 66 65 63 74 65 64 | 20 62 79 20 74 68 65 20 |affected| by the |
|00002de0| 76 61 6c 75 65 20 6f 66 | 0d 74 68 65 20 69 6e 74 |value of|.the int|
|00002df0| 65 67 65 72 20 6f 70 74 | 69 6f 6e 73 2c 20 77 68 |eger opt|ions, wh|
|00002e00| 69 63 68 20 73 68 6f 75 | 6c 64 20 62 65 20 30 20 |ich shou|ld be 0 |
|00002e10| 66 6f 72 20 6e 6f 72 6d | 61 6c 20 6f 70 65 72 61 |for norm|al opera|
|00002e20| 74 69 6f 6e 2e 20 20 28 | 49 66 20 74 68 65 0d 73 |tion.  (|If the.s|
|00002e30| 79 73 74 65 6d 20 64 6f | 65 73 20 6e 6f 74 20 73 |ystem do|es not s|
|00002e40| 75 70 70 6f 72 74 20 5c | 63 6f 64 65 7b 77 61 69 |upport \|code{wai|
|00002e50| 74 70 69 64 28 29 7d 2c | 20 74 68 69 73 20 61 6c |tpid()},| this al|
|00002e60| 77 61 79 73 20 72 61 69 | 73 65 73 0d 5c 63 6f 64 |ways rai|ses.\cod|
|00002e70| 65 7b 70 6f 73 69 78 2e | 65 72 72 6f 72 7d 2e 20 |e{posix.|error}. |
|00002e80| 20 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 | Not on |MS-DOS.)|
|00002e90| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00002ea0| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00002eb0| 7d 7b 77 72 69 74 65 7d | 7b 66 64 5c 2c 20 73 74 |}{write}|{fd\, st|
|00002ec0| 72 7d 0d 57 72 69 74 65 | 20 74 68 65 20 73 74 72 |r}.Write| the str|
|00002ed0| 69 6e 67 20 5c 76 61 72 | 7b 73 74 72 7d 20 74 6f |ing \var|{str} to|
|00002ee0| 20 66 69 6c 65 20 64 65 | 73 63 72 69 70 74 6f 72 | file de|scriptor|
|00002ef0| 20 5c 76 61 72 7b 66 64 | 7d 2e 0d 52 65 74 75 72 | \var{fd|}..Retur|
|00002f00| 6e 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |n the nu|mber of |
|00002f10| 62 79 74 65 73 20 61 63 | 74 75 61 6c 6c 79 20 77 |bytes ac|tually w|
|00002f20| 72 69 74 74 65 6e 2e 0d | 0d 4e 6f 74 65 3a 20 74 |ritten..|.Note: t|
|00002f30| 68 69 73 20 66 75 6e 63 | 74 69 6f 6e 20 69 73 20 |his func|tion is |
|00002f40| 69 6e 74 65 6e 64 65 64 | 20 66 6f 72 20 6c 6f 77 |intended| for low|
|00002f50| 2d 6c 65 76 65 6c 20 49 | 2f 4f 20 61 6e 64 20 6d |-level I|/O and m|
|00002f60| 75 73 74 20 62 65 20 61 | 70 70 6c 69 65 64 0d 74 |ust be a|pplied.t|
|00002f70| 6f 20 61 20 66 69 6c 65 | 20 64 65 73 63 72 69 70 |o a file| descrip|
|00002f80| 74 6f 72 20 61 73 20 72 | 65 74 75 72 6e 65 64 20 |tor as r|eturned |
|00002f90| 62 79 20 5c 63 6f 64 65 | 7b 70 6f 73 69 78 2e 6f |by \code|{posix.o|
|00002fa0| 70 65 6e 28 29 7d 20 6f | 72 0d 5c 63 6f 64 65 7b |pen()} o|r.\code{|
|00002fb0| 70 6f 73 69 78 2e 70 69 | 70 65 28 29 7d 2e 20 20 |posix.pi|pe()}.  |
|00002fc0| 54 6f 20 77 72 69 74 65 | 20 61 20 60 60 66 69 6c |To write| a ``fil|
|00002fd0| 65 20 6f 62 6a 65 63 74 | 27 27 20 72 65 74 75 72 |e object|'' retur|
|00002fe0| 6e 65 64 20 62 79 20 74 | 68 65 0d 62 75 69 6c 74 |ned by t|he.built|
|00002ff0| 2d 69 6e 20 66 75 6e 63 | 74 69 6f 6e 20 5c 63 6f |-in func|tion \co|
|00003000| 64 65 7b 6f 70 65 6e 7d | 20 6f 72 20 62 79 20 5c |de{open}| or by \|
|00003010| 63 6f 64 65 7b 70 6f 73 | 69 78 2e 70 6f 70 65 6e |code{pos|ix.popen|
|00003020| 7d 20 6f 72 0d 5c 63 6f | 64 65 7b 70 6f 73 69 78 |} or.\co|de{posix|
|00003030| 2e 66 64 6f 70 65 6e 7d | 2c 20 6f 72 20 5c 63 6f |.fdopen}|, or \co|
|00003040| 64 65 7b 73 79 73 2e 73 | 74 64 6f 75 74 7d 20 6f |de{sys.s|tdout} o|
|00003050| 72 20 5c 63 6f 64 65 7b | 73 79 73 2e 73 74 64 65 |r \code{|sys.stde|
|00003060| 72 72 7d 2c 20 75 73 65 | 0d 69 74 73 20 5c 63 6f |rr}, use|.its \co|
|00003070| 64 65 7b 77 72 69 74 65 | 28 29 7d 20 6d 65 74 68 |de{write|()} meth|
|00003080| 6f 64 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |od..\end|{funcdes|
|00003090| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|000030a0| 65 73 63 7d 7b 57 4e 4f | 48 41 4e 47 7d 0d 54 68 |esc}{WNO|HANG}.Th|
|000030b0| 65 20 6f 70 74 69 6f 6e | 20 66 6f 72 20 5c 63 6f |e option| for \co|
|000030c0| 64 65 7b 77 61 69 74 70 | 69 64 28 29 7d 20 74 6f |de{waitp|id()} to|
|000030d0| 20 61 76 6f 69 64 20 68 | 61 6e 67 69 6e 67 20 69 | avoid h|anging i|
|000030e0| 66 20 6e 6f 20 63 68 69 | 6c 64 20 70 72 6f 63 65 |f no chi|ld proce|
|000030f0| 73 73 0d 73 74 61 74 75 | 73 20 69 73 20 61 76 61 |ss.statu|s is ava|
|00003100| 69 6c 61 62 6c 65 20 69 | 6d 6d 65 64 69 61 74 65 |ilable i|mmediate|
|00003110| 6c 79 2e 0d 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 |ly..\end|{datades|
|00003120| 63 7d 0d                |                         |c}.     |        |
+--------+-------------------------+-------------------------+--------+--------+